home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / timit10.arc / TIMIT.DOC < prev    next >
Text File  |  1990-05-12  |  4KB  |  130 lines
  1. /*
  2.  
  3.  
  4. TIMIT.DOC
  5. Version 1.0
  6. May 9, 1990
  7.  
  8.  
  9. Programmer:  Lamar O. Keller
  10.              209 Overlook Road
  11.              Savannah, GA 31410
  12.              912/897-6567
  13.  
  14.  
  15. Description:
  16.  
  17. TIMIT is a time logger to keep track of PC-Pursuit, Starlink, GENIE,
  18. CompuServe, etc. time usage.  The program will create individual time 
  19. logs for each application to be timed.  The program maintains an ASCII 
  20. file(s) that contain log-on date, time, session elapsed time, and 
  21. accumulated elapsed time since the last reset.  The file(s) records elapsed 
  22. time in hours, minutes, and seconds up to 1000 hours.  The timer may be 
  23. reset at any time.
  24.  
  25.  
  26. Usage:
  27.  
  28. To start the timer for a session, type
  29.  
  30.    timit 1 filnam <ntr>
  31.          
  32.            where filnam = DOS filename for ASCII file, with NO extension
  33.  
  34. To stop the timer for a session, type
  35.    
  36.    timit 2 filnam <ntr> 
  37.  
  38. To reset and initialize the timer for a new log, type
  39.  
  40.    timit 3 filnam <ntr>  
  41.  
  42. The 3 switch MUST be used first for a time log to initialize the timer 
  43. log and to place a title header at the top of the text file.
  44.  
  45. To automate the timer, the timer may be started and stopped from batch 
  46. files or your communication program script files.
  47.  
  48. The time information is maintained in an ASCII file(s) named filnam.TXT.  
  49. This file(s) may be viewed with the DOS TYPE command, a text editor, or 
  50. word processor.  Of course, the file(s) may be printed with the DOS 
  51. PRINT command.
  52.  
  53. filnam.TXT may be erased if desired.  TIMIT will create a new .TXT 
  54. file(s) if needed.  filnam.TXT is updated whenever the timer is stopped 
  55. ( TIMIT 2 filnam ).
  56.  
  57.  
  58. Examples:
  59.  
  60. To keep track of usage on PC-Pursuit, first initialize the timer with
  61.  
  62.    timit 3 PURSUIT
  63.  
  64. After initialization, the timer may be started with
  65.    
  66.    timit 1 PURSUIT
  67.  
  68. and stopped with
  69.  
  70.    timit 2 PURSUIT
  71.  
  72. For GENIE, use
  73.  
  74.    timit 1 GENIE   (after initialization for the GENIE log)
  75.  
  76. etc.
  77.  
  78. As many logs may be created as desired.
  79.  
  80.  
  81. How it works:
  82.  
  83. TIMIT uses two files for each time log - filnam.TXT and filnam.BIN.  The 
  84. TXT file is described above.  filnam.BIN is a one record binary file 
  85. that maintains session starting date and time, and the total elapsed 
  86. time since the last reset.
  87.  
  88. TIMIT requires that filnam.BIN be present for starting and stopping the 
  89. timer.  If it is erased, it will be recreated when the timer is reset 
  90. ( TIMIT 3 filnam ).
  91.  
  92. TIMIT is not TSR, therefore any potential interferences are eliminated.  
  93. TIMIT gets it's time information from DOS.  If the DOS date/time is 
  94. incorrect, the date/time recorded by TIMIT will also be incorrect.   
  95. However, assuming that you don't change the DOS date/time between 
  96. starting and stopping TIMIT, the indicated elapsed times will be correct.
  97.  
  98. TIMIT was written in Microsoft C, and optimized for execution speed.
  99.  
  100.  
  101. Disclaimer:
  102.  
  103. No warranty of any kind is offered with this program.  The author of 
  104. the program assumes no liability for any damages, consequential or 
  105. otherwise, that may arise from the use of this program.
  106.  
  107.  
  108. Payment:
  109.  
  110. TIMIT is a shareware software product, and is not free.  If you find 
  111. it useful, please send a payment of $10.00 and your name and address to 
  112. the program author.  Your payment will support the shareware concept.  
  113. Registered users will receive the source code, if requested, and updates 
  114. at no cost.  Comments and suggestions for improvement are welcome.
  115.  
  116.  
  117. Revision History:
  118.  
  119. Rev 0.0 4/30/90 
  120. Initial Release as PCP_TIM.EXE
  121.  
  122. Rev 1.0 5/9/90
  123. Released as TIMIT.EXE.  Added capability for multiple time log creation 
  124. and maintenance.
  125.  
  126.  
  127.  
  128. */
  129.  
  130.